home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 751-760 / 752 / toolmanager / scripts / tm-csh.doc < prev    next >
Text File  |  1995-03-18  |  6KB  |  132 lines
  1.                INSTALLATION OF THE CSH SCRIPTS FOR TOOLMANAGER
  2.                ===============================================
  3.  
  4.                                  1. Purpose
  5.                                  ----------
  6.  
  7. In  this directory, there are four scripts.  They all have an appicon for use
  8. in ToolManager.
  9.     view.sh    -  shows/plays files of any type dropped on it
  10.     edit.sh    -  edits (DPaint, SoundTracker, CED) files of any type
  11.     unpack.sh  -  de-archives all archive types (.lzh, .zoo, .dms an more)
  12.     pack.sh    -  creates an archive of any files dropped on it
  13. There are two additional scripts:
  14.     class.sh   -  contains the information on how to determine file types.
  15.  
  16.  
  17.  
  18.                                  2. Problems
  19.                                  -----------
  20.  
  21. The  main  problem  is  that  you'll have to do some installation work first,
  22. especially if you haven't already installed csh.  For full functionality, csh
  23. 5.16  is  required, which probably isn't even out when you read this.  You'll
  24. also  have to specify your personal viewing/editing/extracting tools and your
  25. AmigaDOS search path to the the script 'class.sh'.
  26.  
  27.  
  28.  
  29.                             3. You don't have csh
  30.                             ---------------------
  31.  
  32. That's  your fault :-) First, you have to get csh itself, as it's not in this
  33. archive.   You  can get csh 5.15 from Fish Disk 512, or if you have access to
  34. FTP, from ab20.larc.nasa.gov (/amiga/utils/system/cli/shells/csh515.lzh).  If
  35. possible, get csh 5.16. See below for limitations of csh 5.15.
  36.  
  37.  
  38.  
  39.                             4. Basic Installation
  40.                             ---------------------
  41.  
  42. Add  a line to your startup-sequence that assigns the logical device CSH:  to
  43. some directory on your HD.  Copy all .sh and .brush files from this directory
  44. to  CSH:.   Copy  ToolManager.config  from  this  directory  to S:, or if you
  45. already have one, append it to yours.
  46. Now  edit  the file CSH:class.sh.  If you already have a customized class.sh,
  47. add  the first few lines of this class.sh to it.  At the top, you have to add
  48. a  path  command  that  sets  the  search path for the displaying and editing
  49. utilities. You can also add full paths to all utilities, see below.
  50. Csh  itself does not need to be running when you're using ToolManager, but it
  51. has  to  be  either resident or in CSH:  or in C:  for ToolManager to find it
  52. (unless you specify a full path name in ToolManager.config).
  53.  
  54.  
  55.  
  56.                               5. Customization
  57.                               ----------------
  58.  
  59. Let's have a look at a typical line in class.sh:
  60.     class ascii   suff=.doc suff=.txt chars act view=more edit=Ed
  61.             N         R         R       R    K      A         A         A
  62. Here  N means the name of the class, R is a recognition method, K is the key-
  63. word  that  indicates  the  following  are  action  definitions, an A are the
  64. actions. If you want to use muchmore instead of more, just enter
  65.     class ascii   suff=.doc suff=.txt chars act view=muchmore edit=Ed
  66. If  muchmore  is  not in the path defined at the top of class.sh, you have to
  67. specify a full path name.  The additional thing you have to know what actions
  68. are performed by the various AppIcons:
  69.  
  70.   Icon          Script       Action
  71.   ---------------------------------
  72.   eye        -  view.sh   -  view
  73.   hammer     -  edit.sh   -  edit
  74.   explosion  -  unpack.sh -  extr
  75.   implosion  -  pack.sh   -   
  76.  
  77. For  additional  information,  e.g.   creating  new file classes and actions,
  78. refer to your csh.doc, chapter 'object oriented features'.
  79.  
  80.  
  81.  
  82.                             6. Csh 5.15 vs. 5.16
  83.                             --------------------
  84.  
  85. An  old  limitation  of csh 5.15 showed up when I wrote these scripts.  It'll
  86. misinterpret file names with embedded blanks in the command line (csh -c).  I
  87. have  added  support for this in csh 5.16.  As soon as you get it, change the
  88. 'RealName'  field  in ToolManager.config from 'csh -ac ...' to 'csh -aC ...'.
  89. There's a patch in class.sh that solves the problem with the name 'Ram Disk:'
  90. but  not  other names with embedded blanks.  The patch only active if the csh
  91. version  is  smaller  than  5.16 so be sure to change ToolManager.config when
  92. upgrading.
  93.  
  94.  
  95.                            7. Usage of the scripts
  96.                            -----------------------
  97.  
  98. view.sh:   Drop  one  icon  on  the  eye  AppIcon.   If  the file type can be
  99. determined  and  the  viewer can be started, it will be shown.  If the viewer
  100. accepts multiple file names in the command line (most do) you extended-select
  101. any  number of icons and drop them on the AppIcon.  They must all be the same
  102. type.   If  you  drop a drawer on the AppIcon, drawer/* will be shown, so the
  103. type  of  the  alphabetically  first item determines which viewing program is
  104. started.
  105.  
  106. edit.sh:   Basically  the  same  as with view.sh, except that most file types
  107. cannot be edited yet, so you must configure yourself.
  108.  
  109. unpack.sh:   Either drop an archive on the AppIcon, so it will be unpacked to
  110. RAM:   (you  can  modify this) or extended select an archive and a drawer, so
  111. the archive will be unpacked to the drawer.  Remember that the workbench does
  112. not notice if new files appear, so you have to perform an 'Update'.
  113.  
  114. pack.sh:  Either you drop a single or a set of icons on the AppIcon, in which
  115. case  a  file requester will ask you for a new archive name, or you drop some
  116. icons  plus  an  archive on the AppIcon, then the files will be added to that
  117. archive.
  118.  
  119.  
  120.                                  8. Various
  121.                                  ----------
  122.  
  123. Problems when doing scripts of your own:  Starting a csh without a CLI causes
  124. some.   Never  forget  the  -a option.  And you won't get to see stderr as of
  125. yet.   Also  remember  that the path is unset.  If you have specific problems
  126. with  csh,  or have found new and exciting applications of csh in conjunction
  127. with ToolManager, you can contact me.  My address is in csh.doc.
  128.  
  129.  
  130.  
  131.                              U. Dominik Mueller
  132.